DELETE request method

Die DELETE HTTP-Methode fordert den Server auf, eine angegebene Ressource zu löschen.

Die DELETE-Methode hat keine definierten Semantiken für den Nachrichteninhalt, daher sollte dieser leer sein.

Anfrage hat einen Inhalt Kann
Erfolgreiche Antwort hat einen Inhalt Kann
Sicher Nein
Idempotent Ja
Cache-fähig Nein
Erlaubt in HTML-Formularen Nein

Syntax

http
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>

Identifiziert die Zielressource der Anfrage, wenn kombiniert mit den Informationen im Host Header. Dies ist ein absoluter Pfad (z.B., /path/to/file.html) in Anfragen an einen Ursprungsserver, und eine absolute URL in Anfragen an Proxys (z.B., http://www.example.com/path/to/file.html).

<query> Optional

Eine optionale Abfragekomponente, der ein Fragezeichen ? vorangestellt ist. Häufig verwendet, um identifizierende Informationen in Form von key=value Paaren zu übermitteln.

Beispiele

Erfolgreiches Löschen einer Ressource

Die folgende Anfrage fordert den Server auf, die Ressource file.html zu löschen:

http
DELETE /file.html HTTP/1.1
Host: example.com

Wenn die Anfrage erfolgreich ist, gibt es mehrere mögliche erfolgreiche Antwortstatuscodes. Eine 204 No Content-Antwort bedeutet, dass die Anfrage erfolgreich war und keine zusätzlichen Informationen an den Client gesendet werden müssen:

http
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT

Eine 200 OK-Antwort bedeutet, dass die Anfrage erfolgreich war und der Antwortinhalt eine Darstellung des Ergebnisses enthält:

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234

<html>
  <body>
    <h1>File "file.html" deleted.</h1>
  </body>
</html>

Eine 202 Accepted-Antwort bedeutet, dass die Anfrage akzeptiert wurde und wahrscheinlich erfolgreich sein wird, aber die Ressource noch nicht vom Server gelöscht wurde.

http
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234

<html>
  <body>
    <h1>Deletion of "file.html" accepted.</h1>
    <p>See <a href="http://example.com/tasks/123/status">the status monitor</a> for details.</p>
  </body>
</html>

Spezifikationen

Specification
HTTP Semantics
# name-delete

Browser-Kompatibilität

Der Browser verwendet die DELETE-Methode nicht für benutzerinitiierte Aktionen, daher gilt "Browser-Kompatibilität" nicht. Entwickler können diese Anfragemethode mit fetch() festlegen.

Siehe auch